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now available for the previous 30 days. 
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November 6, 2012—v7. Major content revision. 


iTunes Connect Sales and Trends Guide: App Store March 4, 2015 
CONFIDENTIAL 


Sales and Trends 


Sales and Trends on iTunes Connect allows you to: 
- View sales within a selected time period 
- Group your sales data (for example, by territory) 


- Filter sales by one or more values (for example, by content title and transaction type) 


Top Content Page 


Sales and Trends shows sales information for all of your top content by default. 


@oe < . 2 ajolo im 


iTunes Connect Sales and Trends el 


Sales of "An App" in US v 
Content v AnApp x Territory ~ United States x Add Filters + Clear All 


Units ? Proceeds ? 


15.7K 252% $32.9K 252% 


i 


Dec 22 - Dec 25, 2010 


Content Territory Platform Category Content Type Transaction Type CMB Version 


Units per Day Areav th 


Content Content Type ID 


An App 


A Developer 


1@ App 123456789 15.7K 


User Guide: Download User Guide Take a Tour 


Tabs 
To view your completed sales by units or by proceeds in U.S. dollars, select the appropriate tab. 


The number below the tab name represents the total sales for the current period in the date 
selector. You can also view the percentage of change between the selected date period and the 
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previous period. For example, if you select a date period of the last seven days, then the 
percentage change compares the selected seven days with the prior seven days. 


Date 


Choose any time period in the Date section. You can click a predefined period (for example, Last 
7 Days) or enter a date range. 


Date Slide Control 


You can also choose a period with the date slider below the main graph: drag the left and right 
handles to set the beginning and end dates. You can then click and drag the specified time 
window forward and backward in time, if desired. 


Group By 
You can group your sales data by various criteria. For example, to view sales across multiple 
territories, choose By Territory. 


Filters 


Use filters to create customized sales views. For example, you can view just the sales of a 
specific app within a specific territory. To return to the default view, click Clear All. 


Graph 
The graph displays your data according to your chosen date range, group, and filters. 


Table 


The table at the end of the page displays information about your sales and your proceeds 
based on the selected date period, group, and filters. 


Click any row in the table to add the corresponding value to your filters. This will also 
automatically update the table content to display subgroups. For example, if you select group 
by territory and click the Europe row, the table will display data for all App Store territories in 
Europe. 
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Top Content Page Features 


Saved Views 


To save your current chosen date range, group, and filter selections, click Save next to Untitled 
Report. You can later choose your saved views from the Top Content menu. 


Export 


To download the data currently displayed by the graph, or copy it to the clipboard, click the 
download button in the upper right of the graph. 


Custom Territory Groups 
To create custom territory groups that filter your content according to territories you've 


selected, choose Create Custom Territory Group from Territory in the Filters menu. 
Reports Page 


Download your Sales and Trends reports by choosing Reports from the Top Content menu. If 
you have more than one contract, choose the vendor for each of your contracts. 
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Reports 


Sales and Trends provides three basic kinds of reports: Sales Summary, Newsstand Detailed, and 
Opt-In. 


The Sales Summary report shows aggregated sales for each of your apps. If you have one or 
more Newsstand apps, you can download the Newsstand Detailed report that shows individual 
sales. For Newsstand apps, you can also download Opt-In reports that contain contact 
information for customers who chose to opt-in to share their information. 


The following table summarizes the available reports: 


Report Type Report Subtype Date Types 

| Sales Summary Daily, Weekly, Monthly, Yearly 
Sales Opt-In Weekly 
Newsstand Detailed Daily, Weekly 


Downloading Reports 


To download reports from Sales and Trends on iTunes Connect, go to the Reports page and 
select a vendor, report period, and date. You can also download reports using the Autoingestion 
tool. 


All reports are delivered as tab-delimited text files in ZIP format. Opt-In reports are password- 
protected. To open these files, use a decompression tool that supports password-protected ZIP 
files. The password is provided on the Reports page. 


Availability 


Reports are only available at certain times and only retained for certain periods of time. Reports 
should be downloaded regularly for your records. Apple does not store or regenerate the data 
after these periods have expired. For details, see Appendix D. 


- Daily reports include data for the previous day and are retained for 30 days 


- Weekly reports include data starting on Monday and ending on Sunday of the previous week. 
Weekly reports are available on Mondays and retained for 26 weeks 


- Monthly reports are available five days after the month's end date and are retained for 12 
months 


- Yearly reports are available six days after the year’s end date and are retained indefinitely 
- Reports are available by 6 a.m. in each territory’s respective time zone 


Autoingestion Tool 


You can use the Autoingestion tool to download reports from the command line or through a 
custom script that you create. Follow the steps below to set up and use the Autoingestion tool. 
Note that Java 1.6 or later is required. 
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* Download the Autoingestion.class file to the directory where you want the reports delivered. 


- You must not alter or disseminate the Autoingestion tool for any reason. Apple reserves 
the right to revoke access for usage or distribution beyond its intended use. 


You must create a text file that contains your Apple ID and password in the format below. 
Note that parameters with <> are placeholders; you must insert your own values. 


userID = <Apple ID> 
password = <password> 


The text file must use the file extension “properties” and can only contain one Apple ID and 
password. Save the file in the same directory as Autoingestion.class. 


To retrieve a report, open a command line in a tool such as the Terminal app in OS X, change 
to the directory where Autoingestion.class is located and run the command below. 


java Autoingestion <properties filename> <vendor id> <report_type> 
<date type> <report subtype> <date> 


- The table below describes the parameters and values that Autoingestion uses. 


- All parameters are required, except for the date. If the date parameter is not provided, the 
latest available report will be downloaded. 


- You must delimit parameters with a space. 


Make sure the file extension is “.properties” For 
example, jane_doe.properties. 


Your unique vendor number | The vendor ID for which you want to download 
the report. For example, 80012345. 


Sales or Newsstand 


report_subtype Summary, Detailed, or Opt-In | Opt-In only applies to Sales report. 


date (optional) YYYYMMDD (Daily or The date of the report you are requesting. Date 
Weekly) parameter is optional. If it is not provided, you 
YYYYMM (Monthly) will get the latest report available. 
YYYY (Yearly) 


Examples 


The examples below assume that the user Jane Doe, who works for a company with the vendor 
ID 80012345, has created a properties file called jane_doe.properties that is located in the same 
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directory as Autoingestion.class: 


Summary of sales for Sep 19, 2013 | 3 utoingestion jane doe.properti 80012345 
Daily Summary 20130919 


Summary of sales for Sep 2013 java Autoingestion jane_doe.pr ti 80012345 
Sales Monthly Detailed 201309 


Opt-In report for week ending java Autoingestion jane doe.pr cti 80012345 
Sep 15, 2013 Sales Weekly Opt-In 20130915 


Detailed Newsstand report for java Autoingestion jane _doe.properti 80012345 
week ending Sep 15, 2013 Newsstand Weekly Detailed 20130915 


Reading Reports 


All reports contain a header row with the field names for each column. The reports include 
transactions that can be tracked by SKU, vendor ID, or Apple ID. 


For a complete list of report fields, see Appendices A, B, and C. For sample reports, see 
Appendices M,N, and O. 
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Appendix A - Sales Report Field Definitions 


Report Field Report Data Type Values p Notes 
Provider CHAR(5) - APPLE Up to 5 Characters The service provider in your 
reports (typically Apple). 
Provider Country CHAR(2 Up to 2 Characters 
la VARCHAR(100) Up to 100 Characters 
Developer VARCHAR(4000) Up to 4000 
Characters 


VARCHAR(600) Up to 600 Characters 
VARCHAR(100) Up to 100 Characters 


Product Type VARCHAR(2 Up to 20 Characters Defines the type of transaction 

Identifier (for example, initial download, 
update, and so on). For more 
information, see Appendix D. 


DECIMAL(18,2) Up to 18 Characters 


Developer DECIMAL(18,2) Up to 18 Characters 
Proceeds (per item) 


Begin Date Date in MM/DD/YYYY 
End Date Date in MM/DD/YYYY 


Customer Currency | CHAR(3 Up to 3 Characters Three-character ISO code 
indicating the customer's 
currency. For more information, 
see Appendix G. 

Country Code CHAR(2 Up to 2 Characters Two-character ISO country code 
indicating the App Store territory 
for the purchase. For more 
information, see Appendix E. 


Currency of Up to 3 Characters The currency in which your 
Proceeds proceeds are earned. For more 
information, see Appendix G. 


Apple Identifier DECIMAL(18,0) Up to 18 Characters The Apple ID for your app. 
DECIMAL(18,2) Up to 18 Characters Price displayed on the App Store. 
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Promo Code VARCHAR(10) Up to 10 Characters If the transaction was part of a 
promotion, this field will contain a 
value. This field is empty for all 
nonpromotional items. For more 
information, see Appendix F. 


Parent Identifier VARCHAR(100) Up to 100 Characters | In-App Purchases will show the 
SKU of the associated app. 


Subscription VARCHAR(10) Up to 10 Characters Defines whether an auto- 
renewable subscription is new or 
a renewal. For more information, 
see Appendix H. 


Period VARCHAR(30) Up to 30 Characters Defines the duration of an auto- 
renewable subscription purchase. 
For more information, see 
Appendix H. 


Category VARCHAR(50) Up to 50 Characters Indicates the category of the app, 
such as Games. 


CMB VARCHAR(5) Up to 5 Characters If the transaction involves a 
"completed" app bundle then this 
field will contain a value of "CMB". 
App credits for completed 
bundles will show a value of 
"CMB-C". Otherwise this field is 
blank. 
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Appendix B - Opt-In Report Field Definitions 


Report Field 
First Name 
Last Name 
Email Address 
Postal Code 
Apple Identifier 
Report Start Date 


Report End Date 


[reoeooatyee [vows [oe 


DECIMAL(18,0) Up to 18 Characters The Apple ID for your app 
DATE Date in MM/DD/YYYY | Date of start of report 
DATE Date in MM/DD/YYYY | Date of end of report. 


VARCHAR(50) Up to 50 Characters Customer's postal code. 


March 4, 2015 
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Appendix C - Newsstand Report Field = 


| Report Field | | Report Field | Report Data Type 

Provider CHAR(5 Up to 5 Characters The service Renee in your reports 
(typically Apple). 

Provider CHAR(2 Up to 2 Characters The service provider country code 

Country (typically US). 

SKU VARCHAR(100) Up to 100 Characters | The product identifier provided by you 
during app setup. 

Developer VARCHAR(4000) Up to 4000 Characters | Provided by you during the initial 
account setup. 


Title | VARCHAR(600) Up to 600 Characters | Provided by you during app setup. | Provided by you during app setup. you during app setup. 
VARCHAR(100) Up to 100 Characters | Provided by you during app setup. 


Product Type | VARCHAR(20) Up to 20 Characters Defines the type of transaction (for 

Identifier example, initial download, update, and 
so on). For more information, see 
Appendix D. 


DECIMAL(18,2) Up to 18 Characters The aggregated number of units. 


Developer DECIMAL(18,2) Up to 18 Characters The proceeds for each item delivered. 
Proceeds 
(per item) 


Customer Up to 3 Characters Three-character ISO code indicating the 
Currency customer's currency. For more 
information, see Appendix G. 


Country CHAR(2 Up to 2 Characters Two-character ISO country code 

Code indicating the App Store territory for the 
purchase. For more information, see 
Appendix E. 


Currency of Up to 3 Characters The currency in which your proceeds 
Proceeds are earned. For more information, see 
Appendix G. 


Apple DECIMAL(18,0) Up to 18 Characters The Apple ID for your app. 

Identifier 

Customer DECIMAL(18,2) Up to 18 Characters Retail Price displayed on the App Store 
Price and charged to the customer. 
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Promo Code | VARCHAR(10) Up to 10 Characters If the transaction was part of a 
promotion, this field will contain a value. 
This field is empty for non-promotional 
items. For more information, see 
Appendix F. 

Parent VARCHAR(100) Up to 100 Characters | In-App Purchases will show the SKU of 

Identifier the associated app. 

Subscription }| VARCHAR(10) Up to 10 Characters Defines whether an auto-renewable 
subscription is new or a renewal. For 
more information, see Appendix H. 

Period VARCHAR(30) Up to 30 Characters Defines the duration of an auto- 
renewable subscription purchase. For 
more information, see Appendix H. 


Download TIMESTAMP(0) Date in MM/DD/YYYY_ | The download date. 

Date (PST) 

Customer DECIMAL(18,0) Up to 18 Characters The customer identification. 

Identifier 

Report Date | DATE Date in MM/DD/YYYY | The date of the report. The date and 

(Local) time is always the local. 

Sales/Return | CHAR(1) Up to 1 Character Can be S or R.R is a refund and not a 
reversal. 

VARCHAR(50) Up to 50 Characters Indicates the category of the app, such 

as Games. 


CMB VARCHAR(5) Up to 5 Characters Credits for Newsstand apps that are part 
of a "completed" app bundle purchase 
will show a value of "CMB-C". Otherwise 
this field is blank. 
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Appendix D - Definition of Day and Week 
How is a day defined for these reports? 


A day starts at 12:00:00 a.m. and ends at 11:59:59 p.m. in the territory's time zone (see table 
below). 


How is a week defined for these reports? 
A week starts on Monday at 12:00:00 a.m. and ends on Sunday at 11:59:59 p.m. 


What time zone is the report date based on? 


U.S., Canada, Latin America Pacific Standard Time (PST), Pacific Daylight 
Time (PDT) 


Europe, Middle East, Africa, Asia Pacific Central Europe Time (CET), Central Europe 
Summer Time (CEST) 


Japan Japan Standard Time (JST) 


Australia, New Zealand Australian Eastern Standard Time (AEST), 
Australian Eastern Daylight Time (AEDT) 


When are these reports available? 


Reports are available by 6 a.m. in each territory's respective time zone. 
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Appendix E - Product Type Identifiers 


Product Type Identifier 1 is only used the first time a customer downloads an app. Family 
Sharing, redownloads, and downloads on multiple devices with the same Apple ID aren't 
counted. 


Updates, which are Product Type Identifier 7, are counted separately for each device where that 


update has been installed, including Family Sharing updates. 


CC 
(2 Ce 
a 
es 
CC 
CC 
eC 
Eo CC CT 
EC 
Co 
C2 
CC 
fs rsorrae —[Pociseto 


iTunes Connect Sales and Trends Guide: App Store March 4, 2015 
CONFIDENTIAL 


Appendix F —- Country Codes 


Country 
Code 


Country 
Code 


Country 


Country Name Code 


Country Name Country Name 


FAL [Albania | fcR | Greece fPA | Panama 


uinea 


oe fot | Guatemala | ppy | Paraguay | 


pal | Anguilla | }aw | Guinea- a PPE Peru 


a =a 7 
Ca | 
_—_ 


Azerbaijan IN India MD Republic Of 
Moldova 


HE fireland PRU [Russia | 


Israel 
Principe 


Benin HO Jordan ee | Sierra Leone 


Ca Ca | CC 
Ca | CC 
fo [ean 


Lao, People’s 
Brazil Democratic ZA South Africa 
Republic of 
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British Virgin ‘ : 


rc 


S 
_ 


Mauritania 


The Grenadines 


Thailand 
Mauritius Trinidad and 
Tobago 


ewe | 


Micronesia, 
TR Turkey 


Federated States 
of 


Dominican NA arabia mn mucin 
Republic 
Emirates 


Egypt Netherlands United Kingdom 


Cc 
ia) 


GQ | A 
nl n{| wn 
mI NI] DD 


= 
fa 
E 


= 
+ 
x < 
° 
rom 
© 


= 
Ee) 


= 

= =< a 
° 
2 
(o>) 


Congo, Republic 
of the 


Czech Republic 


= 
+ 
+ 


= 
Zz 


V 
B 
B 
B 
Kl 
C 
C 
K 
T 
C 
C 
C 
C 
C 
H 
C 
C 


= 


= 


G 
N 
G 
F 
H 
A 
V 
Y 
D 
L 
N 
O 
G 
R 
R 
Y 
Z 
DK 
DM 


= 
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Country 
Code 


Country 
Code 


Country 


Country Name Code 


Country Name 


Country Name 


SV El Salvador NZ New Zealand US United States 


EE Estonia NI Nicaragua UY Uruguay 


Fiji NE Niger UZ Uzbekistan 
VE Venezuela 


VN Vietnam 


France NO Norway 


Gambia OM Oman YE Yemen 


Germany PK Pakistan ZW Zimbabwe 


Ghana PW Palau 


Faire | [a 
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Appendix G - Promotional Codes 


The promo code field values indicate the type of code used. Only one value is possible per line 
in the report. Note that “null” means that this is a standard transaction. The values below can 
appear in the promo code field. 


Promotional codes where the proceeds have been waived. The customer price will 
be 0 and the proceeds will be 0. These transactions are redemptions of iTunes 
Connect Developer Codes. 


Purchase of a gift. 
Redemption of a gift. (Deprecated in September 2013.) 
z 


21 


iTunes Connect Sales and Trends Guide: App Store March 4, 2015 
CONFIDENTIAL 


Appendix H - Currency Codes 


a 
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Appendix | - Subscription and Period Field Values 


The Subscription field indicates whether the purchase of the auto-renewable subscription 
purchase is new or a renewal. 


Subscription Field Value 


Renewal 


The Period field indicates the duration of the auto-renewable subscription purchase or renewal. 


Period Field Value 
7 Days 
1 Month 
2 Months 


3 Months 


6 Months 


1 Year 
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Appendix J - FAQ 


Why am | seeing differences between Financial Reports and Sales and Trends reports? 


The difference between the two reports is the timeframe. Daily and weekly Sales and Trends 
reports are real-time and based on customer interactions. Monthly Payments and Financial 
reports are based on actual financial transactions in our system. 


Note that weekly Sales and Trends reports end on Sunday and start on Monday, while the 
Payment and Financial reports are based on Apple Fiscal Quarters that always end on a 
Saturday. The timeframe difference between the Sales and Trends reports and the Payments 
and Financial reports is intentional. Combining the reports is not recommended because of the 
timeframe and reporting difference. 


What is an Apple ID? 


The Apple ID (Apple Identifer) included in each row of your sales reports is the unique product 
identifier assigned to your app by Apple. Note that this Apple ID is different from your own 
Apple ID that you use to sign into iTunes Connect. Include the Apple ID of your app whenever 
you contact support. 


You can also access an app’s Apple ID by using the links on the app’s product page on the App 
Store. On iOS devices, tap the share icon in the upper right and tap Copy Link. On a Mac, choose 
Copy Link from the pull-down menu below the app’s icon. The copied link will be in the format 
of the example link below. The number in bold is the app’s Apple ID. 


itunes.apple.com/us/app/remote/id284417350?mt=85 


Do weekly reports include the daily reports? 

Yes, weekly reports include the daily reports. Daily and weekly Sales and Trends reports are 
based on the same customer interactions. 

Why do! see a high volume of sales for a short period of time followed by a significant drop? 


It is common that some items see a significant increase in sales and, after a short period, the 
numbers return to normal. This is generally due to promotional activities by blogs or a sales 
campaign that might be associated with your content. 


Why can’t I see any sales for a particular item? 


This can be an indication of an item not being available on the store. Check the product 
availability on iTunes Connect and ensure that the latest contracts are agreed to and in place. If 
your contracts are in place, ensure your app is cleared for sale in the Rights and Pricing area for 
that app in My Apps on iTunes Connect . 


Why there are refunds on my reports? 


Apple will provide a refund if the customer experience was unsatisfactory due to the app’s 
content or quality. 


You can monitor the rate of refunds and the content that is refunded and use it as an indication 
of content quality. 
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When are auto-renewable subscriptions renewed? 


Auto-renewable subscriptions renew on the same day as the original purchase. For example, if a 
monthly auto-renewable subscription is purchased on September 9, then it will auto-renew on 
October 9. 


In cases where the original purchase happens on a day that does not exist for certain months 
then the subscription will auto-renew on the last day of those months, and continue to renew 
on that new day of the month from then on. For example, if the purchase happens on October 
31, it will auto-renew on November 30, December 30, and so on. Note that in February, these 
same subscriptions will start auto-renewing on the 28th day of every month. 
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Appendix K - Report File Names 


The file names for downloaded reports follow the naming convention below: 


Sales Opt-In Weekly O_S W <vendor id> <dat | 0 S W 80012345 2013091 
e> 5 
e> 9 

Detailed Weekly N D W 80012345 2013091 
e> 5 
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Appendix L - Encoded Autoingestion Parameters 


The table below gives numeric and character codes that can be used in place of full parameter 
values. The following sets of three commands, for example, are equivalent: 


java Autoingestion jane _doe.properties 80012345 Sales Daily Summary 20130919 
java Autoingestion jane _doe.properties 80012345 1 2 2 20130919 
java Autoingestion jane _doe.properties 80012345 S D S 20130919 
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